Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working with Movie Time

GetMovieTime

The GetMovieTime function returns a movie's current time. This function returns the time in two formats: as a time value and in a time structure.

pascal TimeValue GetMovieTime (Movie theMovie, 
                               TimeRecord *currentTime);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

currentTime

Contains a pointer to a time structure. The GetMovieTime function updates this time structure to contain the movie's current time. If you do not want this information, set this parameter to nil.

DESCRIPTION

The GetMovieTime function returns a time value. This time value indicates the movie's current time, and it is expressed in the movie's time scale.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can set a movie's current time by calling the SetMovieTime or SetMovieTimeValue functions, which are described on page 2-171 and page 2-170, respectively.